جلب الدردشات التي تحمل التصنيف

الحصول على قائمة بالدردشات المرتبطة بتصنيف محدد.

GET

https://api.wawp.net/v2/labels/{labelId}/chats?access_token=123456789&instance_id=123456789&labelId=1

تسجيل الدخول مطلوب

سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.

تسجيل الدخول

اختبار /v2/labels/{labelId}/chats

يدعم

GET

لا توجد معاملات استعلام مطلوبة

هذه النهاية الطرفية لا تتوقع بيانات في الرابط.

التجميع

غالبًا ما يستخدم للحصول على عدد الدردشات لكل ملصق.

لوحة القيادة

رائع لتصور عبء العمل (مثل 'تذاكر الدعم المعلقة').

توصيات

قم بتخزين الأعداد مؤقتًا وتحديثها فقط عند حدوث أحداث Webhook.
استخدم الرسوم البيانية لعرض توزيع الملصقات للمشرفين.

الاسترجاع المستهدف: إتقان التصفية القائمة على الفئات

نقطة نهاية جلب الدردشات التي تحمل التصنيف هي الجسر الأساسي بين تصنيفك التنظيمي وسير عمل الاتصال الخاص بك. تتيح لك تصفية كامل سجل محادثاتك حسب معرف تصنيف محدد، مما يعيد قائمة خفيفة من معرفات الدردشة وأسمائها التي تنتمي إلى تلك الفئة.

🏗️ المفهوم الأساسي: المعالجة الدفعية القائمة على الفئات

تتيح هذه الواجهة استرجاعاً عالي الكفاءة من خلال نقل منطق التصفية إلى خوادم Wawp المركزية. بدلاً من قيام نظامك بالمرور عبر آلاف سجلات الدردشة الفردية لتحديد "العملاء القدامى" أو "كبار الشخصيات"، يمكنك استرداد قائمة مصفاة مسبقاً في طلب واحد محسن للواجهة.

القدرات الاستراتيجية الرئيسية:

تنسيق التواصل الجماعي: حدد فوراً جميع المشاركين في حملة تسويقية محددة لإرسال رسائل بث مستهدفة.
تدقيق تدفق سير العمل: قياس "كثافة الحالة" لقمع المبيعات الخاص بك — مثل عدد الدردشات العالقة حالياً في حالات "فشل الدفع" أو "مصعدة للمدير".
مزامنة حالة CRM: سحب قوائم مجزأة من جهات الاتصال لضمان أن لوحات تحكم CRM الخارجية تعكس التصنيف المرئي في الوقت الفعلي.

🚀 حالات الاستخدام ذات الأولوية

1. دورة الاحتفاظ الاستباقية

من خلال الاستعلام المنتظم عن تصنيفات مثل "انتظار المتابعة"، يمكن لنظامك تحديد المستخدمين الذين دخلوا في فترة من الخمول، مما يسمح لك بإطلاق رسائل إعادة تفاعل مؤتمتة.

2. تحليل المشاعر المجزأ

في الحسابات ذات الأداء العالي، يستحيل تدقيق كل رسالة. تتيح لك هذه الواجهة تركيز مواردك التحليلية على الأجزاء الأكثر أهمية من خلال جلب الدردشات الموسومة بـ "غير راضٍ" أو "عاجل" فقط.

⚖️ القابلية للتوسع ومعالجة البيانات الكبيرة

بالنسبة لحسابات الشركات التي تضم عشرات الآلاف من المحادثات، تتطلب إدارة قوائم التصنيفات نهجاً محسناً لمنع استنزاف الذاكرة وأخطاء المهلة.

تعيد هذه الواجهة القائمة الحالية الكاملة للتصنيف. للحفاظ على الأداء، نوصي ببث هذه البيانات فوراً إلى طابور معالجة خلفي بدلاً من محاولة معالجتها داخل دورة طلب HTTP الرئيسية.
إذا كنت تعمل في بيئة ذات موارد محدودة، تجنب تخزين المصفوفة الكاملة في الذاكرة؛ قم بمعالجة النتائج كتدفق من المعرفات.

🎯 أفضل الممارسات

عمليات التدقيق المحفزة بالويب هوك: تجنب الاستعلام المتكرر. بدلاً من فحص هذه الواجهة كل 5 دقائق، استخدم ويب هوك إضافة تصنيف لدردشة لتحديث قائمة محلية.
التحقق من حيوية التصنيف: قبل الاستعلام عن الدردشات، تأكد من أن معرف التصنيف لا يزال نشطاً. الاستعلام عن معرف محذوف سيؤدي إلى قائمة فارغة، والتي قد يفسرها نظامك بشكل خاطئ على أنها "صفر عملاء نشطين".

البارامترات

قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.

بارامترات الرابط

جزء من مسار الرابط أو استعلام

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`string`		المعرف الفريد للتصنيف مثال:

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/labels/1/chats";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789"
6}).toString();
7
8
9fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
10  method: "GET",
11  headers: { "Content-Type": "application/json" },
12  
13})
14  .then(async (response) => {
15    if (response.ok) {
16      const data = await response.json();
17      console.log("Success:", data);
18      return data;
19    }
20    
21    // Error Handling
22    if (response.status === 401) {
23      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
24    }
25    if (response.status === 500) {
26      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
27    }
28
29    const errorText = await response.text();
30    console.error(`Error ${response.status}: ${errorText}`);
31  })
32  .catch((error) => console.error("Network Error:", error));

عينات تفاعليةUTF-8

Ln 32, Col 1javascript

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

List of chats retrieved successfully

application/json

object *

Example

{
"0": {
  "id": "123456789@c.us",
  "name": "John Doe"
  }
}

غير مصرح - مفتاح الوصول غير صالح أو مفقود

خطأ في الخادم الداخلي - فشل غير متوقع